There are a total of four players and four mlssiles. The four 
raissiles may be grouped together and used as a 5th player. These 
objects are positioned horizontally by 8 horizontal position registers 
(HPOS (X)). These registers may be reloaded at any time by the proces- 
sor, allowing an object to be replicated many times across a horizontal 
TV line. 

The shape of a player-missile is deterrained by the data in its 
graphics register (GRAF (X)). Players have independent 8 bit graphics 
registers. The four missiles have 2 bit registers (located within one 
address). These registers may also be reloaded at any time by the 
processor, although they are usually changed during horizontal blank 
time. The data in each graphics register is placed on the display 
whenever the horizontal sync counter equals the corresponding horizon¬ 
tal position register. The same data will be displayed every line unless 
the graphic registers are reloaded with new data. 

The player-missile graphic registers may be reloaded by the micro- 
processor (GRAF (X)), or automatically from memory with direct memory 
access (DMA) (see figure II.3). The programmer must place the object 
graphics in memory, write the player-missile base address (PMBASE), and 
enable player-missile DMA (DMACTL, GRACTL). The transfer of object 
graphics from memory to display is then fully automatic. 

PMBASE specifies the most significant byte (MSB) of the address of 
the player-missile graphics. The location of the graphics for each 
object is determined by adding an offset to PMBASE *256 (decimal). The 
bytes between the base address and the missile data are not used by 
Antic, so they are available to the programmer. 

Only the five most significant bits of PMBASE are used with 
single-line resolution and the six most significant bits are used 
with two-line resolution. This means that the location of the graphics 
in memory is restricted to certain page boundaries. Two-line resolu¬ 
tion means that each byte of data is repeated for two lines. (see 
DMACTL, bit 4). 640 (decimal) bytes (5X128) are required for two-line 

resolution and 1280 bytes (5x256) for one-line resolution. 

Each byte in the player graphics area represents eight pixels which 
are to be displayed on the corresponding line(s) of the TV screen. A 
1 indicates that the player's color-lum is to be displayed in that pixel. 
The graphics may be anything, not just rectangles like the ones in figure 
II.3. The player graphics may fill the entire height of the screen or 
they may be only a couple of lines high if the rest of the display data is 
all 0 s. Each byte in the missile display also represents eight pixels, 
two pixels for each missile. Each pixel may be 1, 2, or 4 color clocks, 
and is determined by the SIZE registers. 


P_layfleid : Playfield is always generated by DMA. There are four 
piayfields, each identified by its own color-lum register and collision 
detection. Playfield is generated by two different DMA techniques: 
memory map and character. Both methods provide lists of instructions in 
memory, independent of the player-missile generation. 
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Player-Missile Base Address (PMBASE) = MSB of address 
Resolution is controlled by bit 4 of DMACTL. 


PMBASE*100(hex) 



map in raemory 


Missile TV SCREEN 


Number 
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| j Horizontal position 

j .for each object is set 
* ' independently by 8 

| | horizontal position 

1 I registers. 


1—Each section of memory maps directly 
onto total height of TV screen. 

Object vertical position is determined 
only by its location in its section 
of memory. One byte of memory equals 
1 or 2 television lines vertically. 


Figure II.2 


PLAYER-MISSILE DMA 
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Unlike players and missiles, there are no horizontal position registers 
for playfield. Each player can only have one byte of display per line. 
Playfield, on the other hand, may require up to 48 bytes per line because 
it can fill the entire width of the screen. 

There are three different playfield widths: narrow (128 color 
clocks), Standard (160 color clocks), and wide (192 color clocks). 

The width is selected by storing into DMACTL. The advantage of a narrower 
width is that less RAM is required and fewer machine cycles are stolen for 
DMA. The OS graphics modes use the Standard screen width. 


Display List : The display list is a sequence of display instructions 
stored in memory. These instructions are either one (1) byte or three (3) 
bytes long. The display list can be considered a display program, and the 
Display hist Counter that fetches these instructions can be thought of as 
a display program counter. (10 bit counter plus 6 bit base register.) 

The display list counter can be initialized by writing to DLISTH and 
DLISTL. (or OS shadow registers SDLSTH and SDLSTL). Once initialized 
this counter value is used to address the display list, fetch the instruc- 
tion, display one (1) to sixteen (16) lines of data on the TV screen, 
increment the Display List Counter, fetch the next display Instruction, 
and so on automatically without microprocessor control (see DLISTL and 
DLISTH). DLISTL and DLISTH should be altered only during vertical blank 
or when DMA is disabled (see DMACTL). 

Each instruction defines the type (alpha character or memory map) and 
the resolution (size of bits on screen) and the location of data In memory 
to be displayed for a group (1 to 16) of lines. Each group of lines is 
called a display block. 

THE DISPLAY LIST CANNOT CROSS A 1K BYTE MEMORY BOUNDARY UNLESS 
A JUMP INSTRUCTION IS USED. 


DLISTH (MSB) 

DLISTL (LS fl) 

1 1 1 I 1 Mit J;j 

D7 iDti iDb s Di'i U3 |D2 |Di !UG 


1 I E t 1 1 1 

D? IDfi IBS 104 1D3 B2 IDI lOO 


J ^ __ / 



Fixed (6 bits) Counter (10 bits) 

DISPLAY LIST COUNTER 
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Display Instruction Format : Each instruction consists of either an 
opcode only, or of an opcode followed by two (2) bytes of Operand. 


lopcode 


Single Byte Display Instruction 


“ 1 - 


Operandi 


Triple Byte Display Instruction 


I Operandi J 


The opcode is always fetched first and placed in the Instruction 
Register . This opcode defines the type of instruction (1 or 3 bytes) 
and will cause two more bytes to be fetched if needed. If fetched, 
these next two (2) bytes will be placed in the Memory Scan Counter , 
or in the Display List Counter (if the instruction is a Jump). 


Display Instruction Register (IR) : This register is loaded with the 
opcode of the current display list instruction. It cannot be accessed 
directly by the programmer. There are three basic types of display list 
instructions: blank, jump, and display. 


Blank 

(1-byte) 


i ! 7 ■ '*6 | D5 |D4 I " I Ü I oFol 

This instruction is used to create I to 8 blank lines on the 
display (blackground color). 


D7 1 = display list instruction interrupt 

D6 - D4 0-7 = 1-8 blank lines 

D3 - DO 0 = blank 


Jump__ _ 

(3-bytes) 1D7ID6I Xl Xl 0101 01 1 

This instruction is used to reload the Display List Counter. 

The next two bytes specify the address to be loaded (LSB first). 

D7 1 = display list instruction interrupt 

D6 0 = jump (creates one blank line on display) 

1 = jump and wait until end of next vertical blank 
D5-D4 X = don't care 

D3-D0 1 = jump 

Display 

(1 or 3 bytes) [pT I PS ll>5 ;D4 m |P2 iDl IDÖI 

This instruction specifies the type of display for the next 
display block. 


D7 1 = display list instruction interrupt 

D6 0=1 byte instruction 

1=3 byte instruction (reload Memory Scan Counter 
using address in next two bytes, LSB first). 

D5 1 = vertical scroll enable 

D4 1 = horizontal scroll enable 

D3-D0 2-F = display mode (memory or character map - 

see following pages). 
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Figure II.3 DISPLAY INSTRUCTION 0PC0DES 


















Bit 7 of a display list Instruction can be set to create a display 
list Interrupt if bit 7 of NMIEN is set. The display list interrupt code 
can change the colors or graphics during the middle of the TV display. 

The type of interrupt is determined by checking NMIST. NMIRES clears 
NMIST. The current OS will vector through VDSLST (Hex 200 and 201) to 
the user s display list interrupt routine. See the OS manual for program— 
ming details. 

Bits 5 and 4 of a display type of display list instructions are used 
to enable vertical and horizontal Scrolling. The amount of Scrolling 
depends on the values in the VSCROL and HSCROL registers (to be described 
later). 


Memory Scan Counter ; This counter is not directly accessible by the 
programmer. It is loaded with the value in the last 2 bytes of a 3 byte 
(non-Jump) Instruction. 

This counter points to the location (address) in memory of data to be 
directly displayed (memory map display) or to the location of character 
name Strings to be indirectly displayed (character display). 

A single byte Instruction does not reload this counter. This implies 
a continuation in memory of data to be displayed from that displayed by 
the previous instruction. Since this counter really consists of 4 bits of 
register and 12 of actual counter, a continuous memory block cannot cross 
4K byte memory boundaries, unless the counter is repositioned with a 3 
byte Load Memory Scan Counter instruction. 

LSB Second byte of 3 
byte instruction 

T i i i ~ 

7l6l514l3l2lil0 
\___ J 

/ 

r -^-\ 

~\ i i j j j i i i i i 1 i j ^ 

151 141 131 12I MI 1H| 9 I 5 I 7 I 5 | 5 | 4 | 3 f 2 I 1 I 0 

Fixed (4 bits) Counter (12 bits) 


MSB third byte of 3 byte 
byte instruction 


1 \ ft I 5 t 4 I 3 I 1 I 1 I 0 I 
k_ _/ 



Memory Map Display Instructions : Data in memory (addressed by the 
Memory Scan Counter) is displayed directly when executing a memory (bit) 
map display instruction. As data is being displayed it is also stored in 
a shift register so that it can be redisplayed for as many TV lines as 
required by the instruction. 


II.10 






















Memory Scan Counter 
Addresses each byte 



One line worth of memory is 
loaded into the shift register 



Shift register data is displayed for four TV scan lines in this example. 


In Instruction Register (IR) display modes 8 through F, one or two 
bits of memory are used to specify what is to be displayed on each pixel 
of the screen. Pixel sizes ränge from 1/2 clock by 1 TV line to 4 clocks 
by 8 TV lines. The OS and BASIC Support most of these graphics modes 
(BASIC GRAPHICS coramand). Two modes, C and E, are not supported by the 
OS. These modes have rectangular pixels, which are approximately twice as 
wide as they are high. 

In IR mode F, only one color (C0LPF2) can be displayed. Two different 
luminances are available. If a bit is a zero, then the lurainance of the 
corresponding pixel comes from C0LPF2. If the bit is a one, them the 
luminance is determined by the contents of C0LPF1 (abbreviated to PF1). 

In IR modes 9,B, and C, two different colors can be displayed. A 
zero indicates background color and a one indicates PFO color. The 
difference between the various modes is in the size of the pixels. 

In IR modes 8,A,D, and E, two bits are used to specify the color 
of each pixel. This allows four different colors to be displayed. 

However, only four pixels can be packed into each byte, instead of eight 
as in the previous modes. The bit assignments are shown below. 


SHIFT REGISTER 


7 6 I 5 4 j 3 2 t 1 017 6 j 5 4 I J 2 f 1 0 


2 bits form 
one pixel 
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Character Display Instructions : The first Step in using the character 
map mode is to create a character set in memory (or the built-in OS 
character set at hex E000 may he used). The character set contains eight 
bytes of data for the graphics for each character. The meaning of the 
data depends on the mode. The character set can contain 64 or 128 characters, 
also depending on the mode. The MSB (Most Significant Byte) of the 
address of the character set is stored in CHBASE (or the OS Shadow GHBAS). 

Only the most significant six or seven bits of CHBAS are used (see CHBASE 
description in section III). The other one or two bits and the LSB of the 
address are assumed to be zero, so the character set must Start at an 
acceptable page boundary. 

The next step is to set up the display list for the desired mode. 

Then the actual display is set up. This consists of a string of character 
names or Codes. Each name takes one byte. The last 6 or 7 bits of the 
name selects a character. For a 64 character set, the name would ränge 
from 0 through 63 (decimal). For a 128 character set, the ränge would be 
0 through 127 (decimal). The upper one or two bits of the name byte are 
used to specify the color or other special Information, depending on the 
mode* 


Character names (codes) are fetched by the memory scan counter, and 
are placed in a shift register. On any given line of display the shift 
register rotates, changing only the name portion of the character address, 
as shown below. 

After a full line of character data has been displayed the line 
counter will increment. The next line again addresses all characters by 
name for that line number. 

In 20 character per line modes the seven most significant bits of 
CHBASE are used. This requires that the character set to Start upon a 512 
byte memory boundary. The set must contain 64 charcters, 8 bytes each, 
giving a total of 512 bytes for the set. 

The 40 character per line modes use the six most significant bits 
of CHBASE,forcing the character set to Start on a 1K byte memory boundary. 
The set must have 128 characters of 8 bytes each. This gives a total of 
1024 bytes for the set. 
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There are six charcter map modes, IR modes 2 through 7. Modes 2,6 
and 7 are supported by the OS and BASIC (GRAPHICS 0,1 and 2). 

In IR modes 6 and 7, the upper two bits of each character name select 
one of four playfield colors. For each data bit that contains a one, the 
selected playfield color is displayed. For each zero data bit, the 
background color is displayed. The four character colors plus the background 
color gives a total of five different colors. the mode 6 characters are 
eight lines high and the mode 7 characters are sixteen lines high (each 
data byte is displayed for two lines). 

In IR modes 4 and 5, each character is only four pixels wide instead 
of eight (as in the other modes). Two bits per pixel of data are used to 
select one of three playfield colors, or background. Seven name bits are 
used to select the character. If the most significant name bit is a zero 
then data of 10 (binary) selects PF1. If the name bit 7 is one, then data 
bits of 10 select PF2. This makes it possible to display two characters 
with different colors, using the same data but different name bytes. 

In IR modes 2 and 3, each pixel is half of a color clock in width. 

This makes it possible to have forty eight-pixel-wide characters in a 
Standard width line. These modes are similar to memory mode F in that two 
luminances can be displayed, but only one color is available at a time. 

In IR mode 3, each character is 10 lines high. This makes it possible to 
define lower case characters with descenders. The last fourth of the 
character set (name bits 5 and 6 equal to one) is lowered, The hardware 
takes the first two data bytes and moves them to the bottom of the character, 
displaying two blank lines at the top of the character (see next page). 

In IR modes 2 and 3, bit 7 of the character name is used for inverse 
Video or blanking. This is controlled by CHACTL (Character Control). If 
bit 2 of CHACTL is a one then all of the characters will be displayed 
upside down, regardless of mode. If CHACTL bit 1 is set, then each 
character which has bit 7 of its name set will be displayed in inverse 
Video (the luminances will be reversed). If CHACTL bit 0 is set, then 
each character which has bit 7 set will be blanked (only background wil be 
displayed). Characters can be blinked on and off by setting name bit 7 to 
1 and toggling CHACTL bit 0. Inverse Video and blank apply only to IR 
modes 2 and 3. If both inverse Video and blank are set then the character 
will appear as an inverse Video blank character (solid square). 


Hardware Collision Detection : 60 bits of collision register are 
provided to detect and störe overlap (hits) between players, missiles and 
playfield. These collisions can be read by the microprocessor from 
addresses D000 through D00F. There are no bits for missile to missile 
collisions. 

16 bits for Missile to Playfield 
16 bits for Player to Playfield 
16 bits for Missile to Player 

12 bits for Player to Player (PO to PO always reads as zero, etc.) 


The 1/2 clock memory map mode (IR code 1111) and the 1/2 clock Character 
mode (IR.codes 0011 and 0010) are both playfield type 2 collisions and will 
be stored in bit 2 of the playfield collision registers. 
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IR Mode 3-Upper and Lower Case 
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Vertical and Horizontal Fine Scrolling : Playfield objects are difficult 
to move smoothly. Memory map playfield can be moved by rewriting sectIons 
of memory. However, this is extremely time-consuming if large sectlons 
of the screen must be moved smoothly. Character playfield objects can be 
moved easily in a jerky fashion by changing the memory scan counter. 

However, this results in a large position jump from one character position 
to another, not a smooth motion. For this reason Hardware registers 
(VSCROL and HSCROL) and counters are provided to allow smooth horizontal 
or vertical motion, up to one character width horizontally and up to one 
character height vertically. After this much smooth motion has been 
done by increasing the value in these registers, memory is rewritten or 
the memory scan counter is modified and smooth motion is resumed for 
another character distance. 


Vertical Scrolling : A zone of playfield on the screen can be scrolled 
upward by using VSCROL and bit 5 of the display list instruction. The 
display blocks at the upper and lower boundaries of the zone must have a 
variable vertical size. In particular, the first display block within that 
zone must be shortened from the top, and the last display block must be 
shortened from the bottom (i.e. not all of the top and bottom blocks will 
be displayed). 

The vertical diraension of each display block is controlled by a 4 bit 
counter within the ANTIC, called the 'Delta Counter' (DCTR). tfithout 
vertical Scrolling, it Starts at 0 on the first line, and counts up to a 
Standard value, determined by the current display instruction. (Ex: 
for upper and lower case text display, the end value is 9. For 5 color 
character displays, it is 7 or 15.) 

If bit 5 of the instruction remains unchanged between consecutive 
display blocks, then the second block is displayed in the normal fashion. 

If bit 5 of the instruction goes from 1 to 0 between two consecutive 
display blocks, the second block will Start with Delta = 0, as usual, but 
will count up until delta=VSCROL, instead of the Standard value. This 
shortens that display block from the bottom. 

To define a vertically scrolled zone, the most direct method is to 
set bit 5 to 1 in the first display instruction for that zone, and in all 
consecutive blocks but the last one. If the VSCROL register is not 
rewrittren on the fly, this results in a total scrolled zone that has a 
constant number of lines (provided that the VSCROL value does not exceed 
the Standard individual block size). If N is the Standard block size, the 
top block will be N-VSCROL lines (N > VSCROL ), and the last block will be 
VSCROL + 1 lines: (N-VSCROL) + (VSCROL + 1) = N + 1. Shown on the 
following page is an example of a scrolled zone, top block, for 8 VSCROL 
values for N = 8. 

Horizontal scrolling is described under HSCROL in section III. 
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. . JLjrcpAe- Display List Example: BASIC Starts out in OS graphics mode 0 
which displays 40 characters across by 24 rows. This is IR mode 2 with a 
Standard screen width. The OS sets up the display list near the top of 
RAM with room for the character names at the top of RAM. On a 32 K-byte 
machine, the display list would Start at hex 7C20. The next three bytes 
are hex 70 s to create 24 blank lines. The next byte is a hex 42. The 
4 teils the hardware to reload the raemory scan counter with the following 
address (7C40). This is the address of the data to be displayed. The 2 
teils the hardware to display one line of IR mode 2 characters. The 
next 23 bytes specify 23 rnore lines of mode 2 characters. Hex 41 is the 
Code for jumping and waiting until the end of the next vertical blank. 

The address to jump to is 7C20, the Start of the display list. The next 
960 bytes are the list of characters to be displayed, 40 bytes per line. 
The OS must set up the display list pointer (DLISTH and DLISTL) to the 
starting address of the display list (7C20). It also sets CHBASE to the 
MSB of the address of the character set (E0). 

This is a simple example because only one mode is used and the memory 
Scan counter is only loaded at one point. It is possible to have different 
modes on different lines, change character sets and colors, etc., as shown 
in the example in Section IV. 
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OS Mode 0 Display List (40 chars x 24 lines) 


Address (hex) Data (hex) 

24 blank lines 

reload memory scan counter with 7C40, 
IR mode 2 


23 more IR mode 2 instructions 


Jump back to 7C20 and 

wait for end of vertical blank. 


960 bytes of display data 
(character names) 


Cycle Counting ; As explained previously, the ATARI 800 6502 micropro- 
cessor runs at a rate of 114 machine cycles per TV line (1.79 MHZ). There 
are 262 lines per TV frame and 60 frames per second on the NTSC (IIS) System. 
(The PAL (Europeon) System is different. See the section on NTSC vs. PAL.) 

Each machine cycle is equivalent in length to 2 color clocks. There 
are 228 color clocks on a TV line. The highest resolution graphics modes 
have a pixel size of 1/2 color clock by 1 TV line. Horizontal blank takes 
40 machine cycles. This is when the beam returns to the left edge of the 
screen in preparation for displaying the next TV line. A wait for Sync 
(WSYNC) Instruction stops the 6502. The processor is restarted exactly 7 
machine cycles before the beginning of the next TV line. The program can 
thus change graphics or colors during horizontal blank in preparation for 
the next line. 

The ANTIC chip steals cycles from the 6502 in Order to do memory 
refresh and fetch graphics data when needed. The general rule to remember 
is that each byte fetched from memory requires one machine cycle. If a 
display list memory map Instruction extends over several lines then the data 
is only fetched on the first line. Memory refresh takes 9 cycles out of 
every line, unless pre-empted by a high-resolution graphics mode. Memory 
refresh continues during vertical blank. 

Missile DMA takes one cycle per line in the one-line resolution mode 
and one cycle every’other line in the two line resolution mode. Missile 
DMA can be enabled without doing player DMA. However, if player DMA is 
enabled then missile DMA will also be done (see DMACTL, GRACTL bits). 

Player DMA requires 4 cycles every one or two lines, depending on the 
resolution used. 
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Each fetch of a display list byte takes one cycle, so three cycles 
are required for a three byte Instruction. 

Player/missile and display list instruction fetch DMA take place 
during horizontal blank, if they are required for the next line. 

In memory map modes, the graphics data is fetched as needed throughout 
the first line of the display list instruction, then saved by ANTIC for 
use in succeeding lines. In character modes, the character codes are 
fetched during the first line of each row of characters, along with the 
graphics data needed for that line. On the next lines, only the graphics 
data is fetched, since ANTIC reraembers the character codes. 

In the 40 x 24 character mode, with a Standard screen width, most of 
the cycles during the top line of each row of characters are requried to 
fetch the character codes and data, so there is only time for one memory 
refresh cycle instead of the usual nine• Less DMA is required with a narrow 
screen width so two memory refresh cycles would occur in this case. 

The memory refresh is done fast enough to make up for the lost cycles 
in the high resolution modes. Once memory refresh Starts on a line, it 
occurs every four cycles unless pre-empted by DMA. 

All Interrupts reach the 6502 near the end of horizontal blank. 

With Standard or narrow screen widths, refresh DMA Starts after the end of 
horizontal blank. 

The time at which ANTIC does cycle stealing is deterministic, but 
depends on the graphics mode, screen width and whether or not horizontal 
scrolling is enabled. Horizontal scrolling requires extra graphics data: 
see HSCROL. 

ANTIC does horizontal scrolling of an even number of color clocks by 
delaying the time at which it DMA's the data. To do an odd number of color 
clocks (which involves half of a raachine cycle), ANTIC has a one color clock 
internal delay. 

Theoretically, it is possible to write a program which changes graphics 
or colors "on the fly", i.e. during the middle of a TV line. However, 
with all the DMA going on, the cycle counting gets to be quite complicated, 
and is beyond the scope of this manual. 

There are a number of delays associated with the display of graphics. 
These occur in the ANTIC and the CTIA. The ANTIC sends data to the CITA 
which adds in the color Information. Thus the timing for changing colors on 
the fly is different from that for changing graphics on the fly. 
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Horizontal Blank DMA Timing 


When DMA is enabled, cycles are Stolen at the times shown below. 
End of 


H Previous_ 
Line 


Horizontal Blank 


20 machine cycles (40 color clocks) 


5 | 4 I 1 I I 1 



WSYNC 


B 

l 


1-9 refresh cycles. 
char. and graphics 
data DMA (depends on 
graphic mode) 


Interrupt 

Address DMA (3-byte display list 
Instruction) 

Player 

Display list Instruction fetch DMA 
Missile DMA 


Cycle Counting Example : This example uses the 40 character by 24 line 
display list given on page 11.24. This display list is 32 bytes long so 
display list DMA takes 32 machine cycles. It takes 960 cycles to DMA the 
characters and 8*960 to DMA the character data. The refresh DMA takes 9 
cycles for each of 262 lines, except for the 24 lines where the characters 
are read, where only 1 refresh cycle occurs. 


DMA description 
display list 
characters 
character data 
refresh 
total 


Machine cycles 
32 

40x24 = 960 

960x8 =7680 

262x9-24x8 =2166 

10838 


Thus the total DMA per frame is 10838 machine cycles. One frame 
is 262 lines with 114 machine cycles per line for a total of 29868 machine 
cycles per frame. Thus 36% of each frame is required for DMA in OS graphics 
mode 0. 


HTSC vs. PAL Systems : There are two versions of the ATARI 800: the NTSC 
(United States T.V. Standard) and PAL (one of the European T.V. Standards). 
The PAL System has been designed so that most programs will run without 
being modified. However, some differences may be noticeable. There is a 

Hardware register (PAL) which a program can read to determine which type of 
System it is running on and adjust accordingly. 
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The PAL T.V. has a slower frame rate (50 Hz. instead of 60 Hz.) so 
games will be slower unless an adjustment is made. PAL has more T.V. 
lines per frame (312 instead of 262). The Atari 800 hardware compensates 
for this by adding extra lines at the beginning of vertical blank. Display 
lists do not have to be altered. However, their actual vertical height will 
be shorter. PAL ATARI 800 colors are similar to NTSC because of a hardware 
modification. 
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Audio: There are 4 semi-Independent audio Channels, each with its own 
frequency, noise, and volume control. Each has an 8 bit "divide by N" 
frequency divider, controlled by an 8 bit register (AUDFX). (See audio-serial 
port block diagram.) Each channel also has an 8 bit control register (AUDCX) 
which selects the noise (poly counter) content, and the volume. 


Frequency Dividers : All 4 frequency dividers can be clocked siraultane- 
ously from 64 KHZ or 15 KHZ. (AUDCTL bit 0). Frequency dividers 1 and 3 
can alternately be clocked from 1.79 MHZ (AUDCTL bits 6 and 5). Dividers 2 
and 4 can alternately be clocked with the output of dividers 1 and 3 (AUDCTL 
bits 4 and 3). This allows the following options: 4 channels of 8 bits 
resolution, 2 channels of 16 bit resolution, or 1 channel of 16 bit and 2 
channels of 8 bit. 


Poly Noise Counters : There are 3 polynomial counters (17 bit, 5 bit 
and 4 bit) used to generate random noise. The 17 bit poly counter can be 
reduced to 9 bits (AUDCTL bit 7). These counters are all clocked by 1.79 
MHZ. Their Outputs, however, can be sampled independently by the four 
audio channels at a rate determined by each channel's frequency divider. 

Thus each channel appears to contain separate poly counters (3 types) 
clocked at its own frequency. This poly counter noise sampling is controlled 
by bits 5,6 and 7 of each AUDCX register. Because the poly counters are 
sampled by the "divide by N" frequency divider, the output obviously canno.t 
change faster than the sampling rate. In these modes (poly noise outputted) 
the dividers are therefore acting as "low pass" filter clocks, allowing only 
the low frequency noise to pass. 

The output of the noise control circuit described above consists of 
pure tones (square wave type), or polynomial counter noise at a maxiraum 
frequency set by the "divide by N" counter (low pass clock). This output 
can be routed through a high pass filter if desired (AUDCTL bits 1 and 
2 ). 
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Audio Noise Filters; 
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High Pass Filters : The high pass filter consists of a "D" flip flop 
and an exclusive-OR Gate. The noise control Circuit output is sampled by 
this flip flop at a rate set by the "High Pass" clock. The input and output 
of the Flip Flop pass through the exclusive-OR Gate. If the flip flop input 
is changing mich faster than the clock rate, the Signal will pass easily 
through the exclusive-OR Gate. However, if it is lower than the clock rate, 
the flip flop output will tend to follow the input and the two exclusive-OR 
Gate inputs will raostly be identical (11 or 00) giving very little output. 
This gives the effect of a crude high pass filter, passing noise whose 
minimum frequency is set by the high pass clock rate. Only channels 
1 and 2 have such a high pass filter. The high pass clock for channel 1 
comes from the channel 3 divider. The high pass clock for channel 2 comes 
frora the channel 4 divider. This filter is included only if bit 1 or 2 of 
AUDCTL is true. 


Volume Control : A volume control Circuit is placed at the output of 
each channel. This is a crude 4 bit digital to analog Converter that 
allows selection of one of 16 possible output current levels for a logic 
true audio input. A logic zero audio input to this volume Circuit always 
gives an open Circuit (zero current) output. The volume selection is 
controlled by bits 0 thru 3 of AUDCX. "Volume Control only" mode can be 
invoked by forcing this Circuit's audio input true with bit 4 of AUDCX. In 
this mode the dividers, noise counters, and filter circuits are all discon- 
nected from the channel output. Only the volume control bits (0 to 8 of 
AUDCX) determine the channel output current. 

The audio output of any channel can be completely turned off by writing 
zero to the volume control bits of AUDCX. All ones gives maximum volume. 


C. SERIAL PORT 


The serial port consists of a serial data output (transmission) 
line, a serial data Input (receiver) line, a serial output clock line, a 
bi-directional serial data clock line, and other miscellaneous control lines 
described in the Operatlng System Manual. Data is transmitted and received 
as 8 bits of serial data preceded by a logic zero Start bit, and succeeded 
by a logic true stop bit. Input and output clocks are equal to the baud 
(bit) rate, not 16 times baud rate. Transmitted data changes when the 
output clock goes true. Received data is sampled when the input clock goes 
to zero. 


Serial Output : The transmission sequence begins when the processor 
writes 8 bits of parallel data into the serial output register (SEROUT)(see 
audio and serial port block diagram). When any previous data byte trans¬ 
mission is finished the Hardware will automatically transfer new data from 
(SEROUT) to the output shift register, Interrupt the processor to indicate 
an empty (SEROUT) register (ready to be reloaded with the next byte of 
data), and automatically serially transmit the shift register contents with 
start-stop bits attached. If the processor responds to the Interrupt, and 
reloads SEROUT before the shift register is completely transmitted, the 
serial transmission will be smooth and continuous. 
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Output data is normally transmitted as logic levels (+4V=true OV=False). 
Data can also be transmitted as two tone Information. This mode is selected 
by bit 3 of SKCTL. In this mode audio channel 1 is transmitted in place of 
logic true, and audio channel 2 in place of logic zero. Channel 2 must be 
the lower tone of the tone pair. 

The processor can force the data output line to zero (or to audio 
channel 2, if in two tone mode) by setting bit 7 of SKCTL. This is required 
to force a break (10 zeros) code transmission. 


Serial Output Clock : The serial output data always changes when the 
serial output clock goes true. The clock then returns to zero In the center 
of the output data bit time. 

The baud (bit) rate of the data and clock is determined by audio 
channel 4 audio channel 2, or by the input clock, depending on the serial 
mode selected by bits 4, 5, and 6 of SKCTL. (See chart at end of this 
section.) 


Serial Input : The receiving sequence begins when the hardware has 
received a complete 8 bit serial data word plus start and stop bits. This 
data is automatically transferred to the 8 bit parallel input register 
(SERIN), and the processor Is interrupted to indicate an input data byte 
ready to read in SERIN. The processor must respond to this Interrupt, and 
read SERIN, before the next input data word reception is complete, otherwise 
an input data "over-run" will occur. This over-run will be indicated by bit 
5 of SKSTAT (if bit 5 of IRQST is not RESET (true) before next input complete), 
and means input data has been lost. This bit should be tested whenever 
SERIN is read. Bit 7 of SKSTAT should also be tested to detect frame errors 
caused by extra (or missing) data bits. 


Direct Serial Input : The serial data input line can be read directly 
by the microprocessor if desired, ignoring the shift register, by reading 
bit 4 of SKSTAT. 


Bi-Directional Clock : This clock line is used to either receive a 
clock from an external clock source for clocking transmitted or received 
data, or is used to supply a clock to external devices indicating the 
transmit or reception rate. This clock line direction is determined 
by the serial mode selected by bits 4, 5, and 6 of SKCTL. (See mode chart 
at the end of this section.) Transmitted data changes on the rising edge of 
this clock. Received data is sampled on the trailing edge of this clock. 


Asynchronous Serial Input : Unclocked serial data (at an approximately 
known (+55E) rate) can be received in the asynchronous modes. The receive 
(input) shift register is clocked by audio channel 4. Channels 3 and 
4 should be used together (AUDCTL bit 3=1) for increased resolution. 

In asynchronous modes, channels 3 and 4 are reset by each start bit at the 
beginning of each serial data byte. This allows the serial data rate to be 
slightly different from the rate set by channels 3 and 4. 
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Seri al Mode Control : There are 6 useful modes (of the possible 8) 

controlled by bits 4, 5, and 6 of SKCTL. These are described on the next 
page. 


Note that two tone output (bit 3 of SKCTL) raay be used ln any of these 
modes except for the bottom pair. This is because channel 2 1s used to set 
the output transmit rate and 1s therefore not avallable for one of the two 
tones• 

Note that the output clock rate is identical to the output data rate. 
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I I I 
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Pot scan and keyboard CTRL 
Two Tone Control 


Mode Control Bits 
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1 
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1 
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1 1 
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| 
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T i 
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[ 
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4 

I Chan. 4. Chan. 4 output on 
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4 
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i 

I ! L_J._L 


i 


T 

t 
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|Not Useful 

! 
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1 I I 

A 

„Li_[ 

innut 

I 

_L 
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i i 1 i i 
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1 
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A 

A 
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1 ! 

11 11 

1 

Io 

-i. 

| Chan| 
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•2 

4 Chan.| 

1 2 | 
i 

2 

1 2 

4 

[Recieve rate set by chan. 

J _ L_ 


±- _ ■ 

Outnu t 

14 out on Bi-Direct. Clock line. 1 

1 J 

1 

1 . ! 


f 



-:- 1 

_L 


1 

1 1 
fChan \ 


1 

Input 

|Trans. Rate set by Chan. 

2 . Re- | 

11 11 

: 1 
JLX_ 

li 

1 

Chan 

1 Chan 

not 

|ceive async. (chan 3&4) 

Bi-Dir. 

2 1 

-L-. . 

2 

1 4 

J _ i 

used 

L 

|Clock not used (Tri-state 
|tion i 

condi- 

^ _ L 


Two tone (bit3) not useable in these modes 
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D. INTERRUPT SYSTEM 


There are two basic types of Interrupts defined on the microprocessor: 
NMI (non maskable Interrupt) and IRQ (Interrupt request). It is recommended 
that a thorough understanding of these interrupt types be acquired by 
reading all chapters concerning Interrupts in the 6502 microprocessor 
programming and Hardware manuals. 

In this System NMI interrupts are used for Video display and reset. 

IRQ interrupts are used for serial port communication, peripheral devices, 
timers, and keyboard inputs. 


NMI Interrupts : Even thougb NMI interrupts are "unmaskable" on 
the micrprocessor, this System has interrupt enable (mask) bits for NMI 
function. (Bits 6 and 7 of NMIEN) When these bits are zero NMI interrupts 
are disabled (masked) and prevented from causing a microprocessor NMI 
interrupt. (see NMIEN register description) The 3 types of NMI interrupts 
are: 

1. D7 = Instruction Interrupt (during display time any display 

Instruction with bit 7=1 will cause this interrupt to occur 
(if enabled) at the Start of the last Video line displayed by 
that instruction.) 

2. D6 = Vertical Blank Interrupt (interrupt occurs (if enabled) at 

the beginning of the vertical blank time interval.) 

3. D5 = Reset Button Interrupt (pushing the SYSTEM RESET button will 

cause this interrupt to occur.) 

Since any of these interrupts will cause the processor to jump to the 
same NMI address, the System also has NMI Status bits which may be examined 
by the processor to determine which source caused the NMI interrupt. Bits 
5, 6, and 7 of NMIST serve this function (see NMIST register description). 

These Status bits are set by the corresponding interrupt function (even if 
the interrupt is masked from the processor by NMIEN). The Status bits may 
be reset together by writing to the address NMIRES. 

Two of the Interrupt enable bits (bits 6 and 7 of NMIEN) are cleared 
automatically during System power turn on and therefore these NMI interrupts 
are initially disabled (masked), preventing any power turn on Service routine 
from being interrupted before proper initialization of registers and pointers.* 
They can then be enabled by the processor whenever desired, by writing into 
bits 6 and 7 of NMIEN. Except for the reset button interrupt, they can also 
be disabled by the processor by writing a zero into bits 6 or 7 or NMIEN. 

The reset button cannot be disabled, allowing an unstoppable escape from any 
possible "hangup" condition. 

These NMI interrupt functions are each separated in time (to prevent 
overlaps) and convejrted to pulses by the System hardware, in order to supply 
NMI transitions required by the microprocessor logic. 


* - NOTE: Bit 5 is never disabled and therefore the Reset Button 
should not be pressed during power turn on. 
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ÄfiQ—Ijlterrup t s: IRQ Interrupts are all "maskable" together by one blt 
of the Status reglster on the microprocessor. This bit is set to the 
disable condition automatically by power turn on to prevent Interrupt of 
power turn on Service routines.** In addition to this processor IRQ mask 
bit, there are separate System IRQ Interrupt enable bits for each IRQ 
Interrupt function (bits 0 thru 7 of IRQEN). These bits are not initialized 
by power turn on, and must be initialized by the program before enabling the 
processor IRQ. The 8 types of IRQ Interrupts are: 

D7 = BREAK KEY (depression of the break key) 

D6 = OTHER KEY (depression of any other key) 

D5 - SERIAL INPUT READY (Byte of serial data has been received and is 

ready to be read by the processor in SERIN register). 

D4 = SERIAL OUTPUT NEEDED (Byte of serial data is being transmitted and 
SEROUT is ready to be written to again by the processor). 

D3 = TRANSMISSION FINISHED (serial data transraission is finished. 

Output shift register is empty). 

D2 = TIMER #4 (audio divider #4 has counted down to zero) 

Dl = TIMER #2 (audio divider #2 has counted down to zero) 

DO = TIMER #1 (audio divider #1 has counted down to zero) 

In addition to the above IRQ interrupts (enabled by bits 0 through 7 of 

IRQEN and identified by Status bits 0 thru 7 of IRQST) there are two more 
System IRQ interrupts which are generated over the serial bus Proceed and 
Interrupt lines. 

D7 of PACTL = peripheral "A" Interrupt Status bit 

DO of PACTL = peripheral "A" Interrupt enable bit 

D7 of PBCTL = peripheral "B" interrupt Status bit 

DO of PBCTL = peripheral "B" interrupt enable bit 

These last two interrupts are automatically disabled by power turn on, 
and their Status bits are reset by reading from port A register and port B 
register. (See PORTA, PACTL, PORTB, and PBCTL Register descriptions.) 

The IRQEN register, like the NMIEN register, enables interrupts 
when its bits are 1 (logic true). The IRQST however (unlike the NMIST) has 
interrupt Status bits that are normally logic true, and go to zero to 
indicate an interrupt request. The IRQST Status bits are returned to logic 
true only by writing a zero into the corresponding IRQEN bit. This will 
disable the interrrupt and simultaneously set the interrupt Status bit to 
one. Bit 3 of IRQST is not a latch and does not get reset by interrupt 
disable. It is zero when the serial out is empty (out finished) and true 
when it is not. 


** - NOTE: An NMI also disables the I bit. 



INTERRUPT SUMMARY 


1 

I 

1 

1 

1 

STATUS 

NAME 

1 FUNCTIONS 

ENABLE 

STATUS 

.1 

RESET 

1 

1 

i 

! Display 

TQiLEK 

] 

NMI ST 

i 

1 

1 

Address 

NMI 

1 Instruction 

(Bits 6 thru 

7)|(Bits 5 thru 7)J 

NMIRES 

I INTERRUPTS 

IVert. Blank 

i Norraally Zero I Normally Zero 

(Resets all NMI | 

t 

iReset Button 

i (Disabled) 

I(no Interrupt) 

1 Status toeether)1 

I 

1 

KEYS 

1 

IRQEN 

! 

IRQ ST 

1 

1 

Reset (to true) 


| Serial 

| (Bits 0 thru 

7)|(Bits 0 thru 7) | 

By Zero in 

t 

ports 

zero is 

1 Normally True 

i 

Corresponding i 

1 

Timers 

1 (Disabled)* 

(no interrupt) 

1 

Bit of IRQEN 

; 


1 

! 

i (except Bit 3)* 

IRQ 

1 

1 

1 

1 

1 

INTERRUPTS Peripheral 

| DO of PACTL 

| D7 of PACTL 

1 

Reset by 

1 

A 

jNormally Zero 

|Normally Zero 

! 

Reading PORT A | 

1 

1 

i (Disabled) 

I(no interrupt) 

± 

Register 

1 

1 

1 

| Peripheral 

1 

| DO of PBCTL 

1 

| D7 of PBCTL 

l 

1 

1 

Reset by 

1 

B 

|Normally Zero 

|Normally Zero 

j 

Reading PORT B I 

1 

J_ 

1 (Disabled) 

1(no Interrupt) 

1 

Register 


E. CONTROLLERS 


A variety of Controllers can be plugged into the four jacks on the 
front of the console. This includes Joysticks, paddle (pot), twelve-key 
keyboard, and light pen (when available). 

The Controller ports are read through the PORTA and PORTB regisers 
and the POT and TRIG reglsters. The OS reads these registers during 
vertical blank and Stores into its own RAM locations. These are STICK, 
PADDLO through PADDL7, PTRIG'S and STRIG'S. The OS sets up PORTA AND 
PORTB for input. This is done by setting PACTL or PORTB (Port Control) 
bit 2 to a 0 (to select the direction control register), then writing all 
O's to the desired port. PACTL (PBCTL) blt 2 is then changed back to 
a 1, allowing the program to read from the port. The ports can also be 
set up for output by writing I's instead of O's while the direction control 
mode is selected. 


Joysticks : The Joysticks have four switches, one each for right (R), 

left (L), back (B) and forward (P). 

These switches are read through PORTA and PORTB. A fifth switch is 
activated by pressing the red trigger button. The trigger buttons are 
read from TRIGO through TRIG3. A value of 0 indicates that a button has 
been pressed and a 1 indicates that it has not been pressed. 
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The TRIG registers are normally read directly, but they can be used 
in a latched mode. Writing a zero to bit 2 of GRACTL disables the latches 
and sets them to 1. Writing a 1 to bit 2 enables the latches. If a Joy¬ 
stick trigger button is pushed at any time while bit 2 of GRACTL is 1 
the latch value will change to zero and stay that way. A program can 
use this to determine whether the Joystick trigger buttons have ever been 
pressed during a certain period of time. 


Paddies : The paddles come in pairs, so eight paddles can be connected 

to the four Jacks. The paddles are read by storing into POTGO, then 
reading the POT registers at least 228 lines later. The values ränge from 0 
(with the paddle turned to the right) to 228 (paddle turned counter-clockwise). 
The value indicates how many TV lines it takes to Charge up the capacitor 
which is the series with the potentiometer. Turning the knob to the right 
lowers the resistance, so the capacitor charges up quickly. Turning the 
knob to the left increases the resistance and the charging time. The 
capacitor dump transistors are used to disCharge the capacitors so that a 
new reading can be mode. The POTGO command clears the counters and turns 
off the dump transistors to allow the capacitors to Charge up. The ALLPOT 
register contains one bit for each paddle. When the capacitor has charged 
up to the threshold value the ALLPOT bit changes fron one to zero and the 
POT register contains the correct readings. Bit 2 of SKCTL (Serial Port 
Control) enables fast pot scan. In this mode, It takes only two scan lines 
to Charge up the capacitors to the maximum level instead of 228 lines. Bit 
2 is first set to 0 to dump the capacitors. Then Bit 2 is set to 1 to start 
the pot scan. The fast pot scan is not as accurate as the normal scan mode. 
Bit 2 of SKCTL must be set to 0 to use normal scan mode. Otherwise, the 
capacitors will never dump. Note that some paddles have a ränge smaller 
than 0 to 228 due to differences in the pots. The left and right paddle 
triggers for each paddle pair are read from the left and right bits for the 
corresponding Joystick (PORTA or PORTS). 


Keyboard Controllers : Each keyboard Controller has a twelve-key pad 
and plugs into a Joystick Controller port. The first Step in using the 
keyboard is to select a row by setting the port direction to output and 
writing a 0 to the bit in the PORTA or PORTB register which selects^the 
desired row (see PORTA, SECTION III). The other rows should have l's 
written to them. Columns are read through the POT and TRIG registers (see 
Controller PORT PINOUT chart in section III). Appendix H of the BASIC 
Reference Manual contains a Basic program which reads the Controllers. The 
first and second columns of the keyboard use the same pins as the pots for 
the paddle Controllers, so they are read by reading the POT (or PADDL) 
registers. When a button is pushed, the pot line is grounded, so the pot 
capacitors never Charge up to the threshold level and the reading is 228 
(the maximum). When the button in the selected row and column is not pushed 
the capacitor is connected to +5V through a relatively small resistor, 
giving a POT value of about 2 (this may vary). Since the reading is not 
critical, the fast pot scan mode can be used, so that only a 2 line wait is 
required between selecting the row and reading the POT register. The 
Convention has been adopted of comparing the POT reading with 10 (decimalj. 
If Is it greater than 10 then the button has been pressed. The third 
column is read through the Joystick trigger line, so it works just like a 
joystick trigger (0=button is pressed, l=not pressed). 
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Pen: A light pen is a device that can detect the electron beam 
as it sweeps across the TV screen. It is used to point directly at an image 
on the TV display. Applications include selecting menu Items and drawing 
lines. The ATARI 400/800 hardware was designed so that a light pen can be 

plugged into any of the Joystick Controller ports (see end of section 
III). 


When any one of the Joystick trigger lines (pin 6) is pulled low, the 
ANTIC chip takes the current VCOUNT value and Stores it in PENV. The 
horizontal color clock value (0-227 decimal) is stored in PENH. The least 
significant bit is inaccurate and should be ignored* Since there are a 
number of delays involved in displaying the data and changing the light 
pen register, each System iiust be cal brated. Software which uses the 
light pen should contain a user-interactive calibration routine. For 
example, the user could point the light pen at a crosshair in the center 
of the screen and the program could compute the required horizontal offset. 
PENH will wrap around from 227 to 0 near the right hand edge of a Standard 
width display because of the delay. The pen will not work if it is pointed 
at a black area of the screen, since the electron beara is turned off. It is 
a good idea to read two (or more) values and average them, since the user 
will probably not hold the pen perfectly steady. 
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XII. HARDWARE REGISTERS 


This section lists the Hardware registers and Operating System (OS) 
shadow registers. 

In the following descriptions, true always refers to a bit whose value 

ls 1. 


A. PAL (D014) 


Not 

| D3 ) D2 | Dl iNot ' 

Used 

1 1 1 lUsed 


D3 D2 Dl 

1 1 1 NTSC (US TV) 

000 PAL (European TV) 

This byte can be read by a program to determine which type of System 
the program ls running on. 

B. INTERRUPT CONTROL 


NMIEN (Non Maskable Interrupt Enable)(D40E) ; This address writes data 
to the NMI Interrupt enable bits. 


0 = disabled (masked) 
1 = enabled 


1 

1 

Not 

_D7 J 

tss. 1 

Used 


D7 Display List Instruction Interrupt Enable. This bit is 

cleared by Power Reset, and may be set or cleared by the 
processor. 

D6 Vertical Blank Interrupt Enable. This bit is cleared by Power 
Reset, and may be set or cleared by the processor. 

SYSTEM RESET Button Interrupt 

This Interrupt is always enabled. The SYSTEM RESET button should 
not be pressed during power turn on. 

(Set to hex 40 by OS IRQ code.) 
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NMIST (Non Maskable Interrupt Status)(D40F) : This address read the NMI 
Status Register (Read by OS NMI code). 


0 = no interrupt 
I = interrupt 



1 

1 1 

Not 

D7 

1 D6 1 

Ui | 

Paed 


D7 This bit identifies an NMI interrupt caused by bit 7 of a 
Display List Instruction. 

D6 This bit identifies an NMI interrupt caused by the beginning 
of vertical blank. 

D5 This bit identifies an NMI interrupt caused by the SYSTEM 
RESET button. 


NMIRES (NMI Status Register Reset)(D40F) : This write address resets 
the Non Maskable Interrupt Status Register (NMIST). 


Not 

Used 


( Written by OS NMI code.) 

IRQST (IRQ Interrupt Status)(D20E) : This address reads the data from 
the IRQ Interrupt Status Register. 

0 = Interrupt 
1 = No Interrupt 

i i 1 T 1 i i 

Oh | P5 D4 I D3 I D2 \U I Mi" 


D7 = 0 Break Key Interrupt 

D6 = 0 Other Key Interrupt 

D5 = 0 Serial Input Data Ready Interrupt 

D4 = 0 Serial Output Data Needed Interrupt 

D3 = 0 Serial Output (Byte) Transmission Finished Interrupt * 

D2 = 0 Timer 4 Interrupt 

Dl = 0 Timer 2 Interrupt 

DO = 0 Timer 1 Interrupt 


* - NOTE: Used for generation of 2 stop bits. See IRQ description 
In section II (no direct reset on bit 3). 
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writes data to the IRQ 


IRQEN (I R.n Interrupt Enabl e:- (D20TU • This address 
Interrupt Enable Etits, 


0 - disable, corresponding IRQST bit is set to 1 
1 = enable 


; I IIf n - 

^7 I p6 | (15 | D4 ! DJ I PS | Dl •' na 


D7 Break Key Interrupt Enable 

D6 Other Key Interrupt Enable 

D5 Serial Input Data Ready Interrupt Enable 

D4 Serial Output Data Needed Interrupt Enable 

D3 Serial Out Transmission Einished Interrupt Enable 

D2 Timer 4 Interrupt Enable 

Dl Timer 2 Interrupt Enable 

DO Timer 1 Interrupt Enable 

OS SHADOW: POKMSK (hex 10) 

Use AND's and OR's to change one bit in POKMSK without affectins 
the others. Store the desired value in both IRQEN and POKMSK. 


C. TV LINE CONTROL 


VCOTJfvT (Vertical Counter ) (D40B) : 
Line Counter (fl most significant bits). 


This address reads the Vertical TV 


07 | Df] I Dh | 04 | DI I n2 | Dl | pQ | 

„„ , V0 not read. 

V8 V7 V6 V5 V4 V3 V2 VI V0 Two line 

resolution 
supplied. 


WSYNC 


. (Walt for Horizontal B lank Synchronism - j.e. wait until Start of 


not used 


This address sets a latch that pulls down on the RDY line to the 
microprocessor, causing it to wait until this latch is automatically reset 
by the beginning of horizontal blank. Display list Interrupts may be 
delayed by 1 line if WSYNC is used. (Used by OS keyboard dick routine.) 
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D. GRAPHICS CONTROL 


DMACTL (Direct Mentory Access Control)(D400) i This address writes data 
into the DMA Control Register. 


Not | 

1 

1 

1 

i 

Used 1 D5 

1 D4 Di 

| ti2 

1 Ml 

1} 0 


D5 

= 

1 

Enable Instruction fetch DMA 

D4 

= 

1 

I Line P/M resolution 

D4 

= 

0 

2 line P/M resolution 

D3 

= 

1 

Enable Player DMA 

D2 

= 

1 

Enable Missile DMA 

Dl,DO 

= 

0 

0 No Playfield DMA 


= 

0 

1 Narrow Playfield DMA 
(128 Color Clocks) 


= 

1 

0 Standard Playfield DMA 
(160 Color Clocks) 


= 

1 

1 Wide Playfield DMA 
(192 Color Clocks) 


See GRACTL. OS Shadow: SDMCTL (22F) default value hex 22 


GRACTL (Graphics Control)(D01D) : This address writes data to the 
Graphic Control Register. 


Not 

1 1 1 

Used 

1 02 i DQ 


D2 = 1 Enable latches on TRIGO - TRIG3 inputs (latches are 

cleared and TRIGO - TRIG3 act as normal inputs when chlfl 
control blt is zero). 

DI = 1 Enable Player DMA to Player Graphics Registers. 

DO = 1 Enable Missile DMA to Missile Graphics Registers. 

DMA is enabled by setting bits in both DMACTL and GRACTL. Setting 
DMACTL only will re’sult in cycles being stolen but no display will be 
generated. 
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CHACTL (Character Control)(D401 ) : This address writes data into the 
Character Control Register. 



Not 

1 

1 

1 


Used 

1 D2 

1 Dl 

DO 


D2 Character Vertical Reflect Bit. This bit is sampled at the 
beginning of each line of characters. If true it causes the 
line of characters to reflect (invert) vertically (for upside 
down characters). 

Dl Character Video Invert Plag (used for 40 Character Mode 

only)• If bit 7 of character code is true this flag causes 
that character to be blue on white Cif normal colors are 
white on blue). 

DO Character Blank (Blink) Flag (used for 40 Character Mode 

only). If bit 7 of character code is true this flag causes 
that character to blank. Blinking characters are produced by 
setting bit 7 of the characters to 1, then periodically 
changing DO of CHACTL. 

OS SHADOW: CHACT (2F3) 


DLISTLC Display List Low )(D402) : This address writes data into the 
low byte of the Display List Counter. 


1 

1 07 

1 1 

1 D6 1 

»5 | 

! 

1 [)4 

f 

1 

1 

1 

1 01 

i fi'tf 



7 

6 


4 

3 

2 

1 

0 


'"Display 

List 

OS SHADOW: 

SDLSTL 

(hex 

230) 



l 

Counter 

Bit 

tPosition. 


DLISTH (Display List High)(D403) : This address writes data into the 
high byte of the Display List Counter. 



1 

1 1 

1 

1 I 


1 1 

D7 

1 D6 

1 Dl 

1 D4 

! D3 

1 D2 

1 TJl 

, DO 1 

15 

14 

13 

12 

11 

10 

9 

8 


OS SHADOW: SDLSTH (HEX 231) 


( Display 
List 
Counter 
Bit 

Position. 


The Display List is a list of display instructions in memory. These 
instructions are addressed by the Display List Counter. Loading these 
registers defines the address of the beginning of the Display List. (See 
sections I and II.) 

Note: The top 6 bits are latches only and have no count capability, therefore 

the display list can not cross a 1K byte memory boundary unless a lum p 
inst ruction is use d. 
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DLISTL and DLISTH should be changed only during vertical blank or with 
DMA disabled. Otherwise, the screen may roll. Bit 7 of NMIEN must be set 
in order to receive display list Interrupts. 

CHBASE (Character Address Base Register)(D409) : This address writes 
data into the Character Address Base Register. The data specifies the raost 
significant byte (MSB) of the address of the desired character set (see 
section II). Note that the last 1 or 2 bits are assumed to be 0. 


40 Character Modes 



Base Address Char Name Line Counter 


20 Character Modes 



Base Address Char Name Line Counter 

OS SHADOW: CHBAS (2F4) 


PMBASE (Player-Missile Address Base Register)(D407) : This address 
writes data into the Player-Missile Address Base Register. The data 
specifies the MSB of the address of the player and missile DMA data (see 
section II). 

One Line Resolution 


If)7 |D6 |35 | S4 [m I not used 


PMBASE 



15 Ui I Ll .12 


Base Address 


Player-Missile Player-Missile Scan 

Select Counter 


* = Not Used 
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HSCROL (Horizontal Scroll Register)(D404) : This address writes data 
into the Horizontal Scroll Register. Only playfield is scrolled, not 
players and missiles. 


not used 

1 

1 


1 


D3 

I D2 

1 DI 

: do 


0 to 15 color 
clock right shifts 

The display is shifted to the right by the number of color clocks 
specified by HSCROL for each display list Instruction that contains a 1 in 
its HSCROL Flag bit (bit 4 of instruction byte). 

When horizontal scrolling is enabled, more bytes of data are needed. 
For a narrow playfield (see DMACTL bits 1 and 0) there should be the same 
number of bytes per line as for Standard playfield with no scrolling. 
Similarly, for Standard playfield use the same number of bytes as for the 
wide playfield. For wide playfield, there is no change in the number of 
bytes and background color is shifted in. 


VSCROL (Vertical Scroll Register)(D405) : This address writes data into 
the Vertical Scroll Register. 


not used 

1 1 


1 


1 D2 j 

Dl 

1 DO 

8 

line display modes 



not used 

1 ! ! 

1 E>3 \ D2 1 

DI 

i 

1 Ein 

16 

line display modes 




The display is scrolled upward by the number of lines specified in 
the VSCROL register for each display list instruction that contains a 1 in 
its VSCROL Flag bit (bit 5 of instruction byte). The scrolled area will 
terminate with the first instruction having a zero in bit 5. (see section 
II for more details). 


PRIOR (Friority)(D01B) : This address writes data into the Priority 
Control Register. 


D7 I D6 I D5 1 D4 I |)3 | D2 ! Dl I DO I 
D7-D6 = 0 D5 

Multiple Color Player Enable. 

This bit causes the logical "or" function of the bits of 
the colors of Player 0 with Player 1, and also of Player 2 
with Player 3. This permits overlapping the position of 2 
players with a choice of 3 colors in the overlapped region. 


III.7 





D4 Fifth Player Enable . 

This bit causes all mlssiles to assume the color of Playfleld 
Type 3. (C0LPF3). Thls allows mlssiles to be posltloned 

together wlth a common color for use as a fifth player. 

D3, D2, Dl, Priority Select (Mutually Exclusive). 

& DO These bits select one of 4 types of priority. Objects with 

higher priority will appear to move in front of objects 
with lower priority. 


* 


Higher 

Priority 


D3=l __D2=l 


[-PF0 

[ | PFO 

l— PFl 

PFl 

PO 

PF2 

PI 

1 [FEH + P5 

P2 

I PO 

P3 — 

1 PI 

|— PF2 

I P2 

PF3 + P5 | P3_| 

BAK 

1 HAK 


Dl=l 

D0=I 

s 

! 


! 

pc-i 

PO ~j 


pi -J | 

PI 


r 

— PFO 

P2 



PFl 

. _ P3 J 


i 

PF 2 

PFO 

1 

PF3 + 5 | 

PFl 

! P2 | 

PF2 

P3 J | 

PF3 + 5 

BAR 

BAK 


NOTH: The use of Priority bits in a "non-exclusive" mode (more than 1 

bit true) will result in objects (whose priorities are in conflict) 
turning BLACK in the overlap region. 

EXAMPL E; PRIOR code = 1010 This will black PO or PI if they are over 

PFO or PFl. It will also black P2 or P3 if they are over PF2 or 
PF3. In the one-color 40 character modes, the luminance of a 
pixel in a character is determined by C0LPF1, regardless of the 
priority. If a higher priority player or missile overlaps the 
character then the color is determined by the player's color. 

OS SHADOW: GPRIOR (26F) 


C0LPF0 - C0LPF3 (Playfield Color) (DQ16, D017. DQ18. D019) : These 
addresses write data to the Playfield Color-Lum Registers. 


! t 1 1 1 | 1 

1 D6 1 D5 1 d4 1 03 1 P2 l ni l nn 

1 



(see COLBK for bit assignment) 


OS SHADOWS: C0L0RQ - 3 (2C4-2C7) 


III.8 







COLBK (Background Color)(D01A) : This address writes data to the 
Background Color-Lum Register. 


Color_ ldjjjUnance 






i I 

Not 

D7 

D6 

D5 

D4 

D3 : D2 1 Dl 

Used 

X 

X 

X 

X 

0 0 0 

2 





0 0 1 






ETC. 






1 1 1 

1 

0 

0 

0 

0 

Grey 

0 

0 

0 

1 

Gold 

0 

0 

1 

0 

Orange 

0 

0 

1 

1 

Red-Orange 

0 

1 

0 

0 

Pink 

0 

1 

0 

1 

Purple 

0 

1 

1 

0 

Purple-Blue 

0 

1 

1 

1 

Blue 

1 

0 

0 

0 

Blue 

1 

0 

0 

1 

Light-Blue 

1 

0 

I 

0 

Turquoise 

1 

0 

1 

1 

Green-Blue 

1 

1 

0 

0 

Green 

1 

1 

0 

1 

Yellow-Green 

1 

1 

1 

0 

Orange-Green 

1 

1 

1 

1 

Light-Orange 


Luminance (black) 


Luminance(white) 


OS SHADOU; C0L0R4 (2C8) 


E. PLAYERS AND MISSILES 

DMACTL, GRACTL, PMBASE and PRIOR also affect players and missiles. 

COLPMO - C0LPM3 (Player-Missile Color) (D012, D013, D014, D0I5 ): These 
addresses write to the Player-Missile Color-Lum Registers. Missiles have 
the same color-lum as their player unless missiles are used as a 5th player 
(see bit 4 of PRIOR). A 5th player missile gets its color from C0LPE3. 

i i i i i i T~i 

D? ■ 1)6 I D5 I D4 D3 I D2 I D l DO * 

(see COLBK for bit assignments) 

OS SHADOWS: PCOLRO - 3 (2C0-2C3) 

GRAFPO - GRAFP3 (Player Graphics Registers): (PO POOP. PI DOPE, P2 POOP » 
P3 D010) ; These addresses write data directly into the Player Graphics 
Registers, independent of DMA. If DMA is enabled then the graphics registers 
will be loaded automatically from the memory area specified by PMBASE(see 
page II.3). 


D7 I D6 I Dj I »4 | D3 | D2 Dl I DO 
Left Right 

Player on TV Screen 
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GRAFM (Missile Graphics Registers)(D011) : This address writes data 
directly into the Missile Graphics Register, independent of DMA. 



M3 M2 Ml MO 


SIZEPO - SIZEF3 (Player Size)(PO D008, Fl D009, P2 DOPA, P3 DOOB) : 
These addresses write data into the Player Size Control Registers. 

Horizontal Size 
Register (Player) 

0 0 Normal Size 

(8 color clocks wide) 

0 1 Twice Normal Size 

(16 color clocks wide) 

1 0 Normal Size 

114 Times Normal Size 

(32 color clocks wide) 

With normal size objects, each bit in the graphics register corresponds 
to one color clock. For larger objects, each bit is extended over more than 
one color clock. 

SIZEM (Missile Size)(D00C) : This address writes data into the Missile 
Size Control Register. 

Horizontal Size 
Register (Missile) 

M3 M2 Ml MO 

0 0 Normal Size 

(2 color clocks wide) 

0 1 Twice Normal Size 

(4 color clocks wide) 

1 0 Normal Size 

114 Times Normal Size 

(8 color clocks wide) 




HPOSPO - HP0SP3 (Player Horizontal Position)(PO D000, PI D0Q1, P2 D002, 
P3 D003) : These addresses write data into the Player Horizontal Position 
Register (see display diagram in section IV). The horizontal positon value 
determines the color clock location of the left edge of the object. Hex 30 
is the left edge of a Standard width screen. Hex DO is the right edge of a 
Standard screen. 
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HPOSMO - HPOSM3 ( Missile Horizontal Position)(MQ DQ04. M l D005 

~ — — M3 — P - Q -°- 7 -), : Xhese addresses write data into the Missile Horizontal 
Position Registers (see HPOSPO description). 


I I I I i j i~i 

D7 I D6 1 P5 I Di. | D3 I D2 I Dl I ]]Q t 

V DELAY .(Vertical De l ay)(DQ1C) : This address writes data into the 
Vertical Delay Register. 


I D7 j D6 | D5 [ D4 I D3 I D2 j Dl j DQ 

P3 p 2 PI PO M3 M2 Ml MO 

VDELAY is used to give one-line resolution in the vertical po- 
sitioning of an object when the 2-line resolution display is enabled. 
Setting a bit in VDELAY to 1 moves the corresponding object down by one 


If player-missile DMA is enabled then changing the vertical location 
of an object by more than one line is accomplished by moving bits around 
in the memory map. If DMA is disabled then the vertical location can be 
set up by assembly language code which Stores data into the graphics 
registers at the desired line. " ' 

__ jlQ . P - P ) M2PF, M3P E (Missile to Plavfi eld Collisions) (D000, D001. 

- D - ° - ° - 2 < DQQ 3) : These addresses read Missile to Playfield Collisions. 

A 1 bit means that a collision has been detected since the last HITCLR, 

Not Used j — j j 

I — C-aro forced) I D3 I D2 | Dl | DO 

■3. 2 1 Ö Playfield Type 

POPF, P1PF. P2PP, P3PF (Player to Playfield Col lisions H D 0 0 A. 

- D - ° - ° - 5 » 0006 > POOTj : These addresses read Player to Playfield "Collisions. 

Not Used _ | ” j : 

(zero forced) I D3 | D2 i Dl | DQ 

3 2 [ C Playfield Type 

.. WOFL. M1PL. M2PL , M3PL (Missile to PlnV&r C ollision)(DOOS. D009. 

P- 0 .QA> POOb),: These addresses read Missile to Player Collisions. 

_ Not Used j “ j j I 

(zero forced) | DJ, I | 2 I Dl | HO 

^ 2 - 11 Player Number 

_ p O p T;i PlPb T P"PL . PJPli _ lFJ_ay.gr to Plaver Collisions )'(DOOC. DOOD. DDUR. 

D00F2,; These addresses read Player to Player Collisions ^ 


Not Used 

! I i 

(ff&ro forced) 

1 D3 1 D2 I Dl 1 DO 


1 0 Player Number 

(Player 0 against Player 0 is always a zero). Etc. 
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HITCLR (Collision "HIT" Clear) 


D01E 


This write address clears all collision bits descrlbed 
above. 


Not 

Used 


F. AUDIO 

AUDCTL (Audio Control)(0208): Thls address writes data into the Audio 
Mode Control Register. (Also see SKCTL two-tone bit 3 and notes). 


l l l : I I 

n7 ' D6 | D5 1 D4 | D3 I D2 Dl i PO 

D7 Change 17 bit poly into a 9 bit below poly. 

Dö Clock Channel 1 with 1.79 MHZ, instead of 64 KHZ. 

D5 Clock Channel 3 with 1.79 MHZ, instead of 64 KHZ. 

D4 Clock Channel 2 with Channel 1, instead of 64 KHZ (16 BIT). 

D3 Clock Channel 4 with Channel 3, instead of 64 KHZ (16 BIT). 

D2 Insert Hi Pass Filter in Channel 1, clocked by Channel 3. 
(See section II.) 

Dl Insert Hi Pass Filter in Channel 2, clocked by Channel 4. 

DO Change Normal 64 KHZ frequency, into 15 KHZ. 


Exact Frequencies : The frequencies given above are approximate. The 
Exact Frequency (fin) that clocks the divide by N counters is given below 
(NTSC only, PAL different). 


FIN 

(Aperoximate) 

FIN 

(Bxdct) 

1.79 MHZ 

1.78979 MHZ 

64 KHZ 

63.9210 KHZ 

15 KHZ 

15.6999 KHZ 


Use modified formula for fout 


Use normal formula for fout 


The Normal Formula for output frequency is: 


Fout = Fin/2N 


Where N = The binary number in the frequency register (AUDF), plus 1 (N=AUDF+1). 
The MODIFIED FORMULA should be used when Fin = 1.79 MHZ and a more exact result 
is desired: 


Fout =’ Fin 

_2 (AUDF + M) 


Where: M = 4 if 8 bit counter (AUDCTL bit 3 or 4 = 0) 

M = 7 if 16 bit counter (AUDCTL bit 3 or 4 = I) 
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A0DF1. AUDF2, AUDF3, AUD74 (Audio Frequency) (D200. D202. D204. D2Q6) 
These addresses write data lato each of the four Audio Frequency Control 
Registers. Each register Controls a divide by "N" counter. 


i:7 

1 

| D6 

__ 

| 

Di 

' 

D3 

1 T>2 

i 

1 DL 

1 

1 Rß 

" r L - 1 1 

-b. 

0 

0 

0 

0 

0 

0 

0 

0 

1 

0 

0 

0 

0 

0 

0 

0 

1 

1 




ETC ■ 





1 


l 

1 

_J_ 

1 

1 




Note: "N" is one greater 
than the binary number 
in Audio Frequency 
Register AUDF(X). 


AUDC1, AUDC2, AUDC3, AUDC4 (Audio Channel Control)(D201. D203. 

D205. D207): These addresses write data into each of the four Audio Control 
Registers. Each Register Controls the noise content and volume of the 
corresponding Audio Channel. 


^oise Content or Distortion Volume 





t 




! 

Divisor "N" set 

HEX 

_D7J 

D6 

D5 \ 

D4 

D3 

D2 

Dl ! DO 

by audio frequency 









register. 

0 

0 

0 

0 

0 




- 17 BIT poly - 5 BIT 









poly - N 

2 

0 

0 

1 

o 1 




- 5 BIT poly - N - 2 

4 

0 

1 

0 

0 




- 4 BIT poly - 5 BIT 









poly - N 

6 

0 

1 

1 

0 




- 5 BIT poly - N - 2 

8 

1 

0 

0 

0 




- 17 BIT poly - N 

A 

1 

X 

1 

0 




- Pure Tone - N - 2 

C 

1 

1 

0 

0 




- 4 BIT poly - N 

1 

X 

X 

X 

1 




- Force Output 









(Volume onlv) 

0 





0 

0 

0 0 

- Lowest Volume (Off) 

8 





1 

0 

0 0 

- Half Volume 

F 





1 

1 

1 1 

- Highest Volume 
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PITCH VALUES FOR THE MUSICAL NOTES-AUDCTL =0, AUDC = hex AX 


ATXDF 


HIGH 

NOTES 


MIDDLE C 


LOW 

NOTES 



Hex 

Dec 

c 

ID 

29 

B 

IF 

31 

kif or Bb 

21 

33 

A 

23 

35 

G# or Ab 

25 

37 

G 

28 

40 

F# or Gb 

2A 

42 

F 

2D 

45 

E 

2F 

47 

D# or Eb 

32 

50 

D 

35 

53 

C# or Db 

39 

57 

C 

3C 

60 

B 

40 

64 

kif or Bb 

44 

68 

A 

48 

72 

G# or Ab 

4C 

76 

G 

51 

81 

F# or Gb 

55 

85 

F 

5B 

91 

E 

60 

96 

D# or Eb 

66 

102 

D 

6C 

108 

C# or Db 

72 

114 

C 

79 

121 

B 

80 

128 

kif or Bb 

88 

136 

A 

90 

144 

Gif or Ab 

99 

153 

G 

A2 

162 

F# or Gb 

AD 

173 

F 

B6 

182 

E 

CI 

193 

D if or Eb 

CC 

204 

D 

D9 

217 

Cif or Db 

E6 

230 

C 

F3 

243 

This write 

address resets all audio 



frequency dividers to thelr "AUDF" value. These dividers generate timer 
Interrupts when they count down to zero (if enabled by IRQEN). (also see 
IRQST) 


IIOT LLSeil 


RANDOM (Random Number Generator)(D20A) : This address 
Order 8 bits of a 17 bit polynomial counter (9 bit, if bit 


reads the high 
7 of AUDCTL=1)• 


D7 i D6 | D5 i D4 I D i I • ! Htl 1 DtJ 
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KEYBOARD AND SPEAKER 


G • 


CONSOL (Console Switch Port)(D01F) : Thls address reads or writes data 
from the console switches and indicators. (Set to 8 by OS Vertical Blank 
code.) 


Not Used 

1 

1 

1 

1 

(«ero forced) 

1 D3 

1 D2 

1 Dl 

1 DO 


Hex 08 should be written to this address before reading the switches. 
Ones written will pull down on the switch line. 

CONSOL Bit Assignment: 


DO 

Game Start ^ 



Dl 

Game Select \ 

- 0 means switch 

pressed. 

D2 

Option Select ( 


D3 

Loudspeaker J 

- should be held 

at 1 


except when writing 0 
momentarily. OS writes a 
1 during vertical blank. 


KBCODE (Keyboard Code)(D209) : This address reads the Keyboard Code, 
and is usually read in response to a Keyboard Interrupt (IRQ and bits 6 or 7 
of IRQST). See IRQEN for Information on enabling keyboard Interrupts. See 
SKCTL bits 1 and 0 for key scan and debounce enable. 


I D7 I D6 | 115 1 D4 I D3 I D2 ; Dl I DH 

D7 = Control Key 
D6 = Shift Key 

Read by OS into shadow CH when key is hit. The OS has a get character 
function which converts the keycode to ATASCII (Atari ASCII). 
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KEYCODE TO ATASCII CONVERSION 


KEY 

CODE 

KEY 

CAP 

m 



■ 

KEY 

CODE 

KEY 

CAP 

M 

■1 

HÜ 

00 

L 

6C 

4C 

OC 


20 

) 

2C 

5B 

00 

01 

J 

6A 

4A 

OA 


21 

SPACE 

20 

20 

20 

02 

J 

3B 

3A 

7B 


22 

• 

2E 

5D 

60 

03 






23 

N 

6E 

4E 

OE 

04 






24 





05 

K 

6B 

4B 

OB 


25 

M 

6D 

4D 

OD 

06 

+ 

2B 

5C 

IE 


26 

/ 

2F 

3F 


07 

* 

2A 

5E 

1F 


27 

A 

* 

* 

* 

08 

0 

6F 

4E 

OF 


28 

R 

72 

52 

12 

09 






29 





OA 

P 

70 

50 

10 


2A 

E 

65 

45 

05 

OB 

U 

75 

55 

15 


2B 

Y 

79 

59 

19 

OC 

RET 

9B 

9B 

9B 


2C 

TAB 

7F 

9F 

9E 

OD 

I 

69 

49 

09 


2D 

T 

74 

54 

14 

OE 

- 

2D 

5F 

IC 


2E 

ff 

77 

57 

17 

OF 

= 

3D 

7C 

ID 


2F 

Q 

71 

51 

11 

10 

V 

76 

56 

16 


30 

9 

39 

28 


11 






31 





12 

C 

63 

43 

03 


32 

0 

30 

29 


13 






33 

7 

37 

27 


14 






34 

BACKS 

7E 

9C 

FE 

15 

B 

62 

42 

02 


35 

8 

38 

40 


16 

X 

78 

58 

18 


36 

< 

3C 

7D 

7D 

17 

Z 

7A 

5A 

1A 


37 

> 

3E 

9D 

FF 

18 

4 

34 

24 



38 

F i 

66 

46 

06 

19 






39 

H 

68 

48 

08 

1A 

3 

33 

23 

* 


3A 

D 

64 

44 

04 

1B 

6 

36 

26 



3B 





IC 

ESC 

1B 

1B 

1B 1 


3C 

CAPS 

* 

* 

* 

ID 

5 

35 

25 



3D 

G 

67 

47 

07 

IE 

2 

32 

22 

FD 


3E 

S 

73 

53 

13 

1F 

1 1 

31 

21 

* 



A 

61 

41 

01 


= special handling 
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H. 


SERIAL PORT (see peripheral connector on console) 


SKCTL (Serial Port control)(D20F) ; This address writes data into the 
register that Controls the conflguation of the serial port, and also the 
Fast Pot Scan and Keyboard Enable. 

(Bits are normally zero 
and perform the functions 
shown below when true.) 


D7 Force Break (force serial output to zero (space))* 


1 1 
07 1 D6 

1 1 1 

■ D5 1 D4 

1 1 
D3 

ITT 

D2 1 Dl 1 DO 


D6^ 

D5 > Serial Port Mode Control (see mode chart at end of 
DAJ Serial port description, page 11.34). 

D3 Two Tone (Serial output transmitted as two tone Signal instead of 
logic true/false.) 

D2 Fast Pot (Fast Pot Scan. The Pot Scan Counter completes its 
sequence in two TV line tiraes instead of one frame time. The 
capacitor dump transistors are completely disabled.) 

DI Enable Key Scan (Enables Keyboard Scanning Circuit) 

DO Enable Debounce (Enables Keyboard Debounce circuits) 

D0-D1 (Both Zero) Initialize (State used for testing and initializing 

Chip) ** 

OS SHADOW: SSKCTL (hex 232) 


The OS enables key scan and debounce and may change the other bits for 
different I/O operations. In particular, an aborted cassette Operation may 
leave the two tone bit in the true state, causing undesirable audio Signals. 
This may be corrected by writing hex 13 to both SKCTL and SSKCTL after doing 
I/O and/or before modifying the audio registers. 


* KOTE: When powered on, serial port output may stay low even if this bit 

is cleared. To get S.P. high (mark), send a byte out (recommend 
00 or FF). 

**N0TE: There is no original power on state. Pokey has no resetpin. 
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SKSTAT (Serial Port-Keyboard Status)(D20F) : This address reads the 
Status register giving Information about the serial port and keyboard. 


(Bits are normally true 
and provide the following 
Information when zero.) 

D7 = 0 = Serial Data Input Frame Error 


I I t I I I I 

I D7 I D6 | D5 [ D4 I D3 I DZ I 1:1 I ft ft 


D6 ■" 0 = Serial Data Input Over-run 

D5 - 0 = Keyboard Over-run 

DA - 0 = Direct from Serial Input Port 

D3 = 0 = Shift Key Depressed 

D2 = 0 = Last Key is Still Depressed 


Latches 
must be 
reset = 1 
(SKRES) 

(D5 and Dö are set to 
zero when new data 
and same bit of IRQST 
is zero) 


Dl = 0 - Serial Input Shift Register Busy 


DO " 1 Not Used (Logic True) 


SKRES (Reset above Status Register)(D20A) : This write address resets 
bits 7, 6, and 5 of the Serial Port-Keyboard Status Register to 1. 


not uaad 


SERIN (Serial Input Data)(D20D) : This address reads the 8 bit parallel 
holding register that is loaded when a full byte of serial input data has 
been received. This address is usually read in response to a serial data in 
interrupt (IRQ and bit 5 of IRQST). Also see IRQEN. 


I I I I I 

D7 I Dh I II5 J D4 I DJ- i>2 I Dl I DD 


Serial I/O Port Connector Pinout ; 



1. 

Clock In 

2. 

Clock Out 

3. 

Data In to Computer 

4. 

GND 

5. 

Data Out of Computer 

6. 

GND 

7. 

Command 

8, 

Motor Control 

9. 

Proceed 

10. 

+5 / Ready 

11. 

Audio In 

12. 

+12 

13. 

Interrupt 



See serial port description in OS 

manual 

for more detai 
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SEROUT (Serial Output Data)(D2QD): This address writes to the 8 bit 
parallel Holding register that is transferred to the output serial shift 
register when a full byte of serial output data bas been transmitted. This 
address is usually written in response to a serial data out interrupt (IRQ 
and bit 4 of IRQST). 


I I I ! I I \ 

D7 1 D6 I P5 1 D4 I Dj I ">2 PI j _L>Q 


I. CONTROLLER PORTS (front of console) 


PORTA (Port A)(D300) : This address reads or writes data from Player 0 
and Player 1 Controller jacks if bit 2 of PACTL is true. This address 
writes to the direction control register if bit 2 of PACTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820 


Data Register-Addressed if bit 2 of PACTL is 1. 


_ Joystick Operation _ 

I ! I I I I I 

D7 | D6 I Di I 04 I Dl I Lj ' Dl I 08 
Right Back Right Back 


Lef t 


Fwd. 


Left 


Fwd*. 


Stickl StickO 

(Jack 2) (Jack 1) 


0=Switch pressed 
l=Switch not pressed 


Paddle 0oc raf, Iq n 


r 

1 1 

1 t ( 1 

1 D7 1 Ob 1 Do D4 

1 D3 1 D-2 1 Dl DQ 


PTRI132 

PTRICÖ 


mir-3 

i --PTRIGi 


0=Switch pressed 
l=Switch not pressed 


I 


Keyboard Controller Opetatipn 


i 


i 


i 


i 


i 


Top Row 
2nd Row 
■ 3rd Row 
4th Row 


t 


B7 I D6 t D5 I H4 I P3 I ÜZ I Dl I Dp 


Top Row 
2nd Row 
3rd Row 
4rd Row 


Jack 2 


Jack 1 


Direction Control Re t s t er-Addressed if bit 2 of PBCTL is 0 


1 

1 1 1 

1 

D? 1 D6 

| 05 1 1J4 D3 

1 02 1 Dl D r l 


Each bit corresponds to a jack pin 


0=input 

l=output 


OS SHADOWS: STICKO (hex 278), STICK1 (279), PTRIG0-3 (27C-27F 
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PACTL (Port A Control)(P302) : This address writes or reads data from 
the Port A Control Register. 


Port A Control 
Register 

Set up register as shown 
{X = descrlbed below) 

D7 - (Read only ) Peripheral A Interrupt Status Bit. Serial 
bus Proceed line. (Reset by reading Port A Register. 

Set by Peripheral A Interrupt.) 

D3 - Peripheral Motor Control line on serial bus (write). 

(0 = On 1 - Off) 

D2 - Controls Port A addressing described above (write). 

(1 = Port A Register 0 = Direction Control Register). 

DO - Peripheral A Interrupt Enable Bit. (Write) 1 = Enable. 
Reset by power turn-on or processor. Set by Processor. 


! I I I I I 

Li7 | D6 | P5 I D4 D3 I D2 I Dl : 00 

x n .1 l x x ■’i x 


PORTB (Port B)(D301) : This address reads or writes data from Player 2 
and Player 3 Controller jacks if bit 2 of PBCTL is true. This address 
writes to the direction control register if bit 2 of PBCTL is zero. I/O for 
both ports (A and B) goes through a 6520/6820. 

Data Register-Addressed if bit 2 of PBCTL is 1 


_ Joystick Operation _ 

T T i i i 

M7 l>6 | 05 | D_4 * D3 I D? I 01 1 IM 

Right Back Right Back 

v T.aft ^ _ Fwä ^ Lef Fwd- j 

Stick3 Stick2 

(Jack 4) (Jack 3) 


0=Switch pressed 
l=Switch not pressed 


Paddle Oneration 

1 

D7 ! D6 

1 

| D5 1 D4 

i 1 1 

' D3 1 V2 1 DJ 1 1>0 



PTRIG6 

1 1 

‘—PTRIG4 



PTRIG7 

1-PTRIG5 


0=Switch pressed 
l=Switch not pressed 


r.c yboard Ci-ntrallaT Opsrat ion 


I 


I 


117 I Pb ! D5 


I j I I I 

I D4 Pi I 02 I :)k_ Llü 


Top Row"\ 
2nd Row L 
3rd Row i 
■ 4th Row^/ 


-Top Row 

- 2nd Row 

- 3rd Row 

■ 4rd Row, 


Jack 4 


Jack 3 
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Dlrection Control Register-Addressed If b it 2 of PBCTL is 0 

i I I I I ! I 

D7 I D6 I D5 i D4 I D3 I D2 i Dl I DO 


Each bit corresponds to a jack pin 

0=Input 
l=output 

OS SHADOWS: STICK2 {hex 27A), STICK3 (27B), PTRIG4-7 (280-283) 


PBCTL (Port B Control)(D303) : This address writes or reads data from 
the Port B Control Register. 


Port B Control 
Register 

Set up register as 
shown (X=Described 
below) 

D7 (Read only ) Peripheral B Interrupt Status Bit. Serial 
bus Interrupt line. Reset by Reading Port B Register. 

Set by Peripheral B Interrupt. 

D3 Peripheral Command Identification. Serial bus Command 
Line. 

D2 Controls Port B addressing described above. 

(1= Port B Register 0 = Direction Control Register) 

DO Peripheral B Interrupt Enable Bit. 1 = Enable. 

Reset by power turn-on or processor. Set by processor. 

(Set to hex 3C by OS IRQ code) 

POTO - P0T7 (Pot Values)(D200-D207) : These addresses read the value (0 
to 228) of 8 pots (paddle Controllers) connected to the 8 lines pot port. 

The paddle Controllers are numbered from left to right when facing the 
console keyboard. Turning the paddle knob clockwise results in decreasing 
pot values. The values are valid only after 228 TV lines following the 
"POTGO" command described below or after ALLPOT changes. 


Read Qiilv 


07 I U6 1 !V> I 04 I DU D2 I DI I DO 

x o i i .x x 5 x 


t I ! I f 

D7 I D6 I D5 I DA I 03 I I Dl I 30 
Each Pot Value (0-228) 


OS SHADOWS: PADDL0 - 7 (hex 270-277) 
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ALLPOT (All Pot Lines Simultaneously)(D2Q8) : This address reads the 
present state of the 8 line pot port. 

Capacitor dump transitors must be turned off by either going to fast 
pot Scan mode (bit 2 of SKCTL) or starting pot scan (POTGO). 


1 )7 . | 56 | E>5 | 1)4 i i>3 | 02 | Ts] [ ilQ 1 

Pot number: 0 = Pot register value 1s valid. 

76543210 1= Pot register value is not valid. 

8 Pot Line States 


POTGO (Start Pot Scan)(D20B) : 


No 

_ Data Bits Used _ 

This write address Starts the pot scan sequence. The pot values 
(P0T0 - P0T7) should be read first. This write strobe is then used causing 
the following sequence. 

1. Scan Counter cleared to zero. 

2. Capacitor dump transistors turned off. 

3. Scan Counter begins counting. 

4. Counter value captured in each of 8 registers (POTO - 
P0T7) as each pot line crosses trigger voltage. 

5. Counter reaches 228, capacitor dump transistors turned 
on. 


(Written to by OS vertical blank code) 


TRIGO. TRIG1. TRIG2, TRIG3 (Trigger Ports)(0 D010. 1 P011, 2 D012, 

3 D013) : These addresses read port pins normally connected to the joystick 

Controller trigger buttons. 


0 = button pressed 
1 = button not pressed 

OS SKADOWS: STRIG0-3 (hex 284-287) 


Not Used 

1 

lyero PoTCedi 

1 DO 


NOTE: TRIGO thru TRIG3 are normally read directly by the microprocessor. 

However, if bit 2 of GRACTL is 1, these inputs are latched whenever 
they go to logic zero. These latches are reset (true) when bit 2 
of GRACTL is set to 0. 
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FEHH (Light Pen Horizontal Color Clock Position)(D40C) : This address 
reads the Horizontal Light Pen Register (based on the horizontal color clock 
Counter in hardware). The values ränge from 0 to decimal 227. Wraparound 
occurs when the pen if near the right edge of a standard-width screen. PENH 
and PENV are modified when any of the Joystick trigger lines is pulled low. 


I I I I i 

t!7 I 06 I H5 1 D4 I Dl f P2 3 01 l ao 


H7 H6 H5 H4 H3 H2 Hl HO 


OS SHADOW: LPENH (hex 234) 


PENV (Light Pen Vertical TV Line Position)(D40D) : This address reads 
the Vertical Light Pen Register (8 most significant bits, same as VCOUNT). 


! 1 t 1 

1 

D7 1 D6 D5 | Ü4 | 

\12 i ' i_2_. 1JE- 


LP8 76543210 LPO not read. Two line 

resolution supplied. 

OS SHADOW: LPENV (hex 235) 


Front Panel (Controller) Jacks as I/O Parts: 

PIA (6520/6820) 

Out: TTL levels, 1 load 
In : TTL levels, 1 load 


Port A Circuit (typical): 


6520 (A> 

22' i . 

POf L 

. ooi 

T 


Jack 


Port B Circuit (typical): 


o+5 

4.7K 


6520 

(B)i 

220 


Port 

'_.001 


T 


Jack 


"Trigger" Port Circuit (typical): 


CTTA Ttlg 


220 a aA > 

_L .001 


T 


Jack 
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Controller Port Pinout: 


Male 

(console) 


Female 

(connector) 


VI 2 3 4 T~j 

\ / 

\ fi i ü q / 



2 


6 



PIN 

JOYSTICK 

Controllers 
PADDLE (POT) 

KEYBOARD 

HARDWARE 

REGISTERS 

OS 

VARIABLES 

1 

Forward 

1 

Top Row* 

Bit 0 or 4** 

Bit 0*** 

2 

Back 


2nd Row* 

Bit 1 or 5** 

Bit 1*** 

3 

Left 

A(Left)Trigger 

3rd Row* 

Bit 2 or 6** 

PTRIGO,2,4,6 






Bit 2*** 

4 

Right 

B(Right)Trigger 

Bottom Row* 

Bit 3 or 7** 

PTRIG1,3,5,7 






Bit 3*** 

5 


POT B(Right) 

Ist Column 

POT 1,3,5,7 

PADDLl,3,5,7 

6 

Trigger Button 


3rd Column 

TRIGO,1,2,3 

STRIGO,1,2,3 

7 


+5 

+5 



8 

GND 

GND 




9 


POTA (Left) 

2nd Column 

POT 0,2,4,6 

PADDLO,2,4,6 


* 

Write 



** 

PORTA 

or 

PORTB 

*** 

STICK 

0 , 

1, 2 
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